home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / GNU / ags_030.lha / readme.amiga < prev   
Encoding:
Text File  |  1993-07-16  |  6.2 KB  |  162 lines
  1. This file is part of Ghostscript.
  2.  
  3. Ghostscript is distributed in the hope that it will be useful, but
  4. WITHOUT ANY WARRANTY.  No author or distributor accepts responsibility
  5. to anyone for the consequences of using it or for whether it serves any
  6. particular purpose or works at all, unless he says so in writing.  Refer
  7. to the Ghostscript General Public License for full details.
  8.  
  9. Everyone is granted permission to copy, modify and redistribute
  10. Ghostscript, but only under the conditions described in the Ghostscript
  11. General Public License.  A copy of this license is supposed to have been
  12. given to you along with Ghostscript so you can know your rights and
  13. responsibilities.  It should be in a file named COPYING.  Among other
  14. things, the copyright notice and this notice must be preserved on all
  15. copies.
  16.  
  17. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  18.  
  19. ***********************************************************************
  20. * This file describes the additional device drivers of the amiga port *
  21. ***********************************************************************
  22.  
  23.  
  24. The 'intui' device
  25. ------------------
  26.  
  27. The intui device was written by Markus (Landi) Landgraf.
  28.  
  29. The intui device is similar to the X device on UNIX stations.  When
  30. ghostscript is invoked with this device chosen, it opens an Amiga
  31. Intuition window with system gadgets and two scroller Gadgets. The
  32. scroller gadgets are meant to scroll through an output that's bigger
  33. than the window ( this is normally the case, because the standard size
  34. of the intuition device is dinA4, wich is bigger than for example a
  35. 15''-Monitor). To use the intui device as default, set the environment
  36. variable 'GS_DEVICE' to 'intui'. The intui device should not disturb
  37. the workbench colors, so it was only possible to make a black and
  38. white display of the output with the darkest workbench color as black
  39. and the brightest as white.  When the output in the window seems
  40. bended, the default settings for device-resolution are no more valid,
  41. the user has to compute it from the size and pixels of her/his display
  42. and set it by the -r option of ghostscript (see use.doc).
  43.  
  44. -------------------------------------------------------------------
  45.  
  46. NAME
  47.   ilbm-retina.doc
  48.  
  49. DATE
  50.   Mar-27 1993
  51.  
  52. DESCRIPTION
  53.   Documentation for ILBM and RETINA drivers
  54.  
  55. AUTHOR
  56.   Andreas Heitmann
  57.   Kasseler Str. 67
  58.   34308 Emstal 1
  59.   Germany
  60.  
  61. EMAIL
  62.   andreas@gotcha.swb.de
  63.   ah@hrz-serv7.hrz.uni-kassel.de
  64.   ah@rbg.informatik.th-darmstadt.de
  65.   heitmann@crunch.ikp.physik.th-darmstadt.de
  66.  
  67. RETINA DOCUMENTATION
  68.  
  69.   The RETINA driver for Ghostscript is only useful for the Amiga
  70.   platform, because the RETINA-hardware does only exist for this
  71.   computer. The driver supports all display modes, but there
  72.   are still bugs in the retina.library which make the 16 bit
  73.   mode useless.
  74.   To display a Postscript picture on a RETINA screen you have to
  75.   set the output device using the Ghostscript command
  76.   line switch 
  77.  
  78.     -sDEVICE=retinaXX
  79.  
  80.   where XX has to be replaced by 8,16 or 24 corresponding to 
  81.   the desired number of BitPlanes. The resolution of the RETINA
  82.   screen is determined from the settings of the RetinaScreenmode
  83.   program.
  84.  
  85.   If you want to use the RETINA-driver by default, you can do this 
  86.   by setting the environment-variable GS_LIB to 'retinaXX'.
  87.  
  88.   After starting Ghostscript with the RETINA device, the page will
  89.   be rendered with the maximum screen size or with the specified
  90.   geometry.
  91.  
  92.   You will observe a remarkable slow down if you render a picture
  93.   with 8 bit CLUT compared to 24 bit. One reason is, that Ghostscript
  94.   has to maintain the CLUT and eventually do the dithering if it runs
  95.   out of colours. The other reason is a bug in the FillRect()-Function
  96.   of the retina.library which makes rectagle filling impossible in the
  97.   8 bit mode. Instead i had to use DrawLine() to fill rectangles.
  98.  
  99.   This bug is fixed in Version 3.8 of retina.library which is contained
  100.   in the update package V1.2, but i won't change the DrawLine-Kludge
  101.   for the next few weeks.
  102.  
  103.  
  104. ILBM DOCUMENTATION
  105.  
  106.   The ILBM driver is a Ghostscript device for converting Postscript
  107.   to the commonly used IFF-ILBM files. This standard file format has
  108.   been defined by Electronics Arts and allows a variable number of
  109.   bitplanes and a simple form of image compression.
  110.  
  111.   There are currently two ilbm devices, which are writing output
  112.   files with a different number of bitplanes, namely the 'ilbm8' device
  113.   which uses a 256 color palette, and the true color 'ilbm24' device
  114.   which writes a 24 bit non-CLUT iff file.
  115.  
  116.   Each mode always uses runlength compression, which in most cases
  117.   makes output files shorter.
  118.  
  119.   There is still a bug in the output routines, which makes the
  120.   request ">>showpage, press <return> to continue<< appear after
  121.   writing the file. You can avoid this by piping NIL: into
  122.   Ghostscript or setting the flag -dNOPAUSE. It may also be
  123.   possible that multi-page output does not work in the current
  124.   version of there ILBM-driver, i don't know if it is allowed
  125.   to put more than one picture in an ILBM file.
  126.  
  127.   I decided to use the Amiga iffparse.library for writing IFF-files,
  128.   so this implementation has two problems: you can't compile in on
  129.   other machines without a replacement for the iffparse.library.
  130.   This is rather hard to fix, if you really want to compile on
  131.   a non-Amiga platform, you have to rewrite the code.
  132.  
  133.   The other problem can be fixed, it arises from the stream management
  134.   the library uses. It is easy to work with the AmigaDOS functions for
  135.   writing files, but GCC implements a slightly different filesystem
  136.   for compatibility with UN*X. It is possible to use the GCC 
  137.   buffered I/O-functions together with the iffparse.library, but
  138.   the price is high: i would have to write assembler inline code,
  139.   which is not very portable nor easy to understand.
  140.  
  141.   So in contrast to other Ghostscript devices, the ILBM-driver uses
  142.   AmigaDOS pathname conventions: full pathnames contain colons, an
  143.   a an initial slash means parent directory, not root directory.
  144.  
  145.  
  146. BUG REPORTS
  147.  
  148.   Bug reports and improvements are welcome, send them to my address
  149.   in the header (EMail preferred).  
  150.  
  151.  
  152. Have fun with Ghostscript,
  153.  
  154.   Andreas
  155.  
  156.      - --  O  
  157.     - --  /   
  158.   --  ***/\=+c
  159.   - - /\*\**/\
  160.       \/ /  \/<
  161.  
  162.  & Landi